home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / ftn / setpup.z / setpup
Encoding:
Text File  |  1998-10-20  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssseeeettttppppuuuupppp((((3333GGGG))))                                                          sssseeeettttppppuuuupppp((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssseeeettttppppuuuupppp - sets the display characteristics of a given pop up menu entry
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee sssseeeettttppppuuuupppp((((ppppuuuupppp,,,,  eeeennnnttttrrrryyyy,,,, mmmmooooddddeeee))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 ppppuuuupppp,,,, eeeennnnttttrrrryyyy,,,, mmmmooooddddeeee
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _p_u_p     expects the menu identifier of the menu whose entries you want to
  17.              change. The menu identifier is the returned function value of the
  18.              menu creation call to nnnneeeewwwwppppuuuupppp.
  19.  
  20.      _e_n_t_r_y   expects the position of the entry in the menu, indexed from 1.
  21.  
  22.      _m_o_d_e    expects a symbolic constant that indicates the display
  23.              characteristics you want to apply to the chosen entry.  You can
  24.              specify more than one at a time by adding or logically or-ing
  25.              these values together.  For this parameter there are four defined
  26.              symbolic constants:
  27.  
  28.              PPPPUUUUPPPPNNNNOOOONNNN, no special display characteristics, fully functional if
  29.              selected.  This is the default mode for newly created menu
  30.              entries.
  31.  
  32.              PPPPUUUUPPPPGGGGRRRREEEE, entry is greyed-out and disabled.  Selecting a greyed-out
  33.              entry has the same behavior as selecting the title bar.  If the
  34.              greyed-out entry has a submenu associated with it, that submenu
  35.              does not display.
  36.  
  37.              PUPBOX Entry has an empty box to the left.
  38.  
  39.              PUPCHE Entry has a checked box to the left.
  40.  
  41. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.      Use sssseeeettttppppuuuupppp to alter the display characteristics of a pop up menu entry.
  43.      Currently, you use this routine to disable and grey-out a menu entry.
  44.  
  45. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  46.      Here is an example that disables a single entry:
  47.  
  48.      menu = newpup()
  49.      call addtop(menu,'menu %t |item 1 |item 2 |item 3 |item 4', 39,0)
  50.      call setpup(menu, 1, PUPGRE)
  51.  
  52.  
  53.      Subsequent calls of ddddooooppppuuuupppp((((mmmmeeeennnnuuuu)))) would display the menu with the menu
  54.      entry labeled ``item 1'' is greyed out, and never gets a return value of
  55.      1.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeettttppppuuuupppp((((3333GGGG))))                                                          sssseeeettttppppuuuupppp((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      dopup, freepu, newpup
  76.  
  77. NNNNOOOOTTTTEEEE
  78.      This routine is available only in immediate mode.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.